Urthman's MDB Construction Kit.

Database in a can? -- Just add water?
The Fast Path to Database Design


This program has been built as a means to design and build Microsoft Access databases quickly from available source code edits for the purpose of accelerating your development projects. While this program can knock out a functional database with an equally functional primary key, Microsoft Access should always be used to test and fine tune the layout. The Urthman's MDB Construction Kit is NOT designed to be used as a substitute for the real thing -- it's just a design aid.

Documentation Contents
General Information Design Notes
Unregistered Features Scripts and Mnemonics
Registered Features Headers and Trailers
Registration Using the Code Module
Contact Information  

1. General Info: Urthman's MDB Construction Kit is a tool for constructing Microsoft Access databases. Databases can be constructed using simple text-file scripts, imported from an existing Microsoft Access database, generated from basic predefined templates, or defined completely from the ground up.

The table editor is designed only for basic record definition functions, but includes the means to define importable and exportable ASCII files, including fixed record lengths and conventional comma and quote-comma delimited files. The table editor also has a section for defining the Primary Key.

The text-file scripts are essentially a beefed up version of typical Visual Basic variable declaration statements. The program reads a text file with these VB statements, and converts this information into a corresponding Microsoft Access database file. For more information, see the page on User Defined Mnemonics.


2. Unregistered Features: Unregistered, the Urthman's MDB Construction Kit is a tool for constructing database files as described above. The program will create the database and all of it's tables, run Microsoft Access and the Urthman's MDB Code Generator as needed.

Without registration, the program is limited to sixteen table definitions, eight database definitions and four user defined script mnemonics. The generated code is also restricted to data export code only.


3. Registered Features: When registered, the table, database and user defined mnemonics limitations are lifted. The option for generating both the Import and Export code is made available.

IMPORTANT NOTICE: The registration option is NOT available to systems that do not have either Microsoft Access 95 or 97 installed. This program is NOT designed as an alternative to Microsoft Access, but as a tool to aid programmers in the design and development of their projects.


4. Design Notes: The Import and Export code modules are generated with the assumption that the Urthman's MDB Code Generator has been or will be used to generate the general function code module for the created database. All references to other code module routines and data variables are constructed around this assumption.

The import code uses the same method for reading delimited files and fixed length records. Delimited files use a one-size-fits-all scheme for breaking out the individual fields. This allows for a single array for all tables regardless of the number of elements, and all elements are checked for leading and trailing quotes, which are stripped off before writing the element into the database.

Note that when importing text to boolean fields, the specific content of the importing data is not relevant to the result. "T", "True", "Y", "Yes", and "1" all result in True, while "F", "False", "N", "No" and "0" all result in False. Actually, any word beginning with "T" or "Y" results in a True, while all other characters are False.

The export code is much more reliant on specifics, since the output needs to meet the specific criteria of the target, not making any assumptions as to the flexibility of that target. For this purpose, the output files can be either comma delimited, quote and comma delimited, or standard CSV files where the string and memo data are in quotes, but the numerics and dates are without quotes.

The Boolean data type can be exported as either: "Y" or "N"; "Yes" or "No"; "T" or "F"; "True" or "False"; "1" or "0". This is set up in the table definition section of the program. In either case, the Boolean data is treated like string data, and for CSV formats, is enclosed in quotes.

When working with fixed length records, a public variable named "RecordSize" is made available for controlling the data length of each record. If "RecordSize" is zero, then the data output is left as is, where the record size is dependant entirely on the collective field lengths alone. If "RecordSize" is less than the resulting output data length, the output record size is truncated to the specified length. If "RecordSize" is greater than the resulting output data length, then the output record is padded with spaces to the specified length.

All of the code modules generated using the Urthman's MDB Construction Kit result in the same collection of public subroutines and functions for use in your project.

Public Subroutines Function Description
OpenImport(TableName, FileName) Opens the ASCII file FileName for importing into the table TableName.

This routine also dynamically allocates the arrays used in the Import process.

ImportData Boolean: Reads a single record from the file FileName, distributes the data elements into the appropriate table related variables and saves the data to the table TableName.

Data variables include RecType to report header and trailer records when encountered. Data variables also include the header and trailer variables with fixed length records. Refer to the generated code module for specifics.

Returns a False when there is no more data, otherwise returns a True.

OpenExport(TableName, FileName) Opens the ASCII file FileName for exporting data from the table TableName.

This routine also dynamically allocates the arrays used in the Import process.

ExportData Long: Copies and converts the table related data variables of the table TableName into an array of string variables, then builds and writes a single record to the file FileName.

Returns a count of records written to the current ASCII text file.

CloseFile Closes the currently open file. The file must be closed before another Import or Export file can be opened.
Export[Header-or-Trailer-Name] Writes the designated header or trailer record to the currently opened text file. For use with fixed length records only.
5. Registration: Send your full name, company name, address, phone number and email address along with a check (or money order) payable to John Stanley Enterprises for $89 for each single user license. I will email (or mail) a registration code to you for unlocking the registered features.

Registered users will receive periodic notification of updates as they might occur via Email. This will continue for the duration of the version 1.x life cycle.

Note: John Stanley Enterprises reserves the right to refuse to issue licenses for nicknames and handles, and most likely will. Site licenses will be issued to real names only, and multiple licenses can and will be issued to company or corporate names.

6. Contact Options:
Report a bug or problem via Email
Send a comment via Email
Optionally, report bugs or make comments to the mailing address below
Contact: John Stanley Enterprises
PO Box 1672
Valrico, FL 33595-1672
URL: http://www.a-znet.com/jse/
Email: urthman@usa.net
  Microsoft, Windows, NT and Visual Basic are registered trademarks of the Microsoft Corporation.